home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / dblcap10.zip / DBLCAP.DOC < prev    next >
Encoding:
Text File  |  1994-05-02  |  6.9 KB  |  154 lines
  1. DBLCAP v1.0 ∙ CapsLock Fixer
  2.               Copyright (c) 1993 by Dale Nurden
  3. ______________________________________________________________________________
  4.  
  5. Ever noticed how often you've pressed the CapsLock key by mistake whilst
  6. typing, only to notice it half a sentence later? Well DBLCAP prevents
  7. this problem by making you press CapsLock TWICE if you really mean it,
  8. and ignoring you if you only press it once.
  9.  
  10. DBLCAP is a small TSR (Terminate and Stay Resident) program that makes
  11. the CapsLock key much less infuriating than it usually is. To use DBLCAP,
  12. you simply need to run the program DBLCAP.COM and it will load itself
  13. into memory. DBLCAP will work quite happily when loaded into high memory
  14. as well, and since it only uses 384 bytes of memory, it can easily fit
  15. into most small memory gaps that would otherwise have been left vacant.
  16.  
  17. An additional feature of DBLCAP is that it includes a hotkey activated
  18. method of clearing the keyboard buffer. You know how sometimes you type
  19. some commands in advance, and just after you've finished you change your
  20. mind? Well now you can simply press Ctrl-Alt-Backspace to instantly
  21. clear the entire keyboard buffer, effectively cancelling anything you
  22. have typed ahead.
  23.  
  24. DBLCAP is released as FREEWARE, with complete Assembly source. Please
  25. read the conditions of distribution, below.
  26.  
  27. ______________________________________________________________________________
  28.  
  29. OK, SO WHAT DOES IT DO?
  30. ~~~~~~~~~~~~~~~~~~~~~~
  31. Once DBLCAP has been installed, it will watch the keyboard for when you
  32. press the CapsLock key. If you only press it once, then everything will
  33. carry on as if you had not pressed it at all, but if you press it a
  34. second time, within a certain time, DBLCAP will pass a single keypress on
  35. to the rest of the system.
  36.  
  37. What this means in simple terms is that if you only press CapsLock once,
  38. DBLCAP will assume you did so by mistake and ignore it. If you really
  39. mean to press it, then you must press it twice (and fairly quickly).
  40.  
  41. DBLCAP comes with the maximum time set to 0.3 seconds. If CapsLock is
  42. pressed twice within 0.3s of each other, the computer will think you
  43. pressed it once. If the time between two presses of the CapsLock key is
  44. greater than 0.3s, NEITHER press will be noticed by the computer.
  45.  
  46. You can change that maximum time by fiddling with the source and then
  47. re-assembling it. To change the time, you must change the values of the
  48. two macros TIMEHI and TIMELO. These two represent the maximum number of
  49. microseconds allowed between presses of CapsLock for it to be noticed,
  50. so to figure out what values they should have, you need to do this:
  51.  
  52.         ( If TIME = number of microseconds you require, then )
  53.         TIMELO = TIME % 65536      (modulas - I'm a C programmer!)
  54.         TIMEHI = TIME / 65536      (integer division)
  55.  
  56. Or you can do like I did and use a calculator with DEC-HEX conversion,
  57. then:
  58.         TIMELO = righthand 4 hex digits
  59.         TIMEHI = next 4 hex digits
  60.  
  61.  
  62. The CTRL-ALT-BACKSPACE hotkey activates the keyboard buffer clearing
  63. feature. As soon as you press this, DBLCAP removes all keys already in
  64. the buffer waiting to be serviced. An example of where this is useful is
  65. when you start a program and then press some silly key by mistake while
  66. it is still loading. You can remove that keypress simply by hitting the
  67. hotkey, and all will be forgotten.
  68.  
  69. You can change the hotkey if you like, once again by fiddling with the
  70. source code and re-assembling it. The macro BACKSPACEmake is the
  71. keyboard makecode for the Backspace key, and the macro BACKSPACEmask is
  72. the shift mask which defines the "Ctrl-Alt-" part of the hotkey. These
  73. are the two things you will need to change, but you'll have to figure
  74. out what changes must be made yourself. Don't change anything else
  75. around there in the source, otherwise you may find that the CapsLock
  76. function no longer works properly.
  77.  
  78. ______________________________________________________________________________
  79.  
  80.  
  81. CONDITIONS OF USE
  82. ~~~~~~~~~~~~~~~~~
  83. I have included the Assembly source to DBLCAP in this package for people
  84. who are interested. The source is released as is, and I make no guarantees
  85. about its reliability, assemble-ility, or anything else. You may use
  86. portions of it in your own shareware/freeware products, but please tell
  87. me about it, just so I know my work is useful to someone else. I don't
  88. want anything in return, except maybe a small note of credit in your
  89. product. Obviously you may also make changes to the source, but if you do
  90. (major changes, that is) then please let me know and send me a copy of
  91. them (if possible). Only because I'm curious, that's all.
  92.  
  93. In addition to the above paragraph: DBLCAP is released as freeware,
  94. which means I don't want anything in return for its use. You could send
  95. me a postcard if you like, mentioning what you like/dislike about it and
  96. suggestions if you have any. The address appears at the end of this
  97. document.
  98.  
  99. WARNING! You use this program at your own risk. I didn't have any
  100. trouble with it on my system, but that doesn't mean that your particular
  101. machine configuration won't disagree with it somehow. I will not accept
  102. any responsibility whatsoever for loss of, or damage to, your data or
  103. system.
  104.  
  105. ______________________________________________________________________________
  106.  
  107. PROGRAM INFORMATION AND REQUIREMENTS
  108. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  109. Assembler: Turbo Assembler v3.1  [TASM DBLCAP.ASM /ML /ZN]
  110. Linker:    Turbo Linker v3.01    [TLINK DBLCAP.OBJ /T]
  111. OS:        MS-DOS 5 (will probably work with MS-DOS 3.x and up)
  112. Memory:    384 bytes when resident, a little more than that to install,
  113.             loaded conventionally or high
  114. Processor: 8086 and up
  115.  
  116.  
  117. HISTORY
  118. ~~~~~~~
  119. 1.0   23/01/94   Updated algorithm to prevent CapsLock from triggering
  120.                   if the CapsLock key is held down.
  121.                  Added hotkey to clear the keyboard buffer.
  122.                  Adjusted to run on an 8086 processor (previous version
  123.                   was limited to minimum 80286).
  124.  
  125. 0.0   17/06/93   Original release. Worked more or less like it was
  126.                   supposed to.
  127.  
  128. ______________________________________________________________________________
  129.  
  130. CONTACTING THE AUTHOR
  131. ~~~~~~~~~~~~~~~~~~~~~
  132. The address to send postcards to, or for any other snailmail
  133. communications, is:
  134.  
  135.                 Dale Nurden
  136.                 14 Willow Crescent
  137.                 Pinetown
  138.                 3610
  139.                 South Africa
  140.  
  141. Or you can contact me at:
  142.  
  143. Email:  dale.nurden@datavert.co.za
  144.  
  145. The Igloo BBS:  International: (+2731) 7643377
  146.                         Local: (031) 7643377
  147.                 Leave mail for "Dale Nurden"
  148.  
  149. Connectix BBS:  International: (+2731) 2669992
  150.                         Local: (031) 2669992
  151.                 Leave Email or a telegram for "TECH" (that's me!)
  152. ______________________________________________________________________________
  153.  
  154.